home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / dialm31.arc / DIALM31.DOC < prev    next >
Text File  |  1990-01-01  |  10KB  |  271 lines
  1.  
  2.     DIALM31.DOC                                                 Page 1
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                      
  10.                                    DIALM
  11.                         A TELEPHONE DIALING PROGRAM
  12.                                Revision 3.0
  13.  
  14.    DIALM is a telephone dialing program which was written as an exercise in
  15.    programming for the Microsoft or compatible mouse.  It was later revised so
  16.    that the mouse is not required, and phone number file maintenance and the
  17.    ability to use multiple phone number files was added.  Revision 3.0 adds
  18.    the use of dialing prefixes.
  19.  
  20.  
  21.  
  22. USING DIALM
  23. ===========
  24.  
  25.    When the program begins, it displays the first few entries from the phone
  26.    number file with the first entry high-lighted and places the mouse cursor
  27.    on the command line:
  28.                                                            Demon
  29.    Setup  Edit  Manual  Find  Again  Up  Dn  Dial  Hangup  Toggle    Quit
  30.                                                            [OFF]
  31.  
  32.    A selection is made by moving the mouse cursor to the required function
  33.    and pressing the left mouse button or by pressing the appropriate
  34.    high-lighted letter on the keyboard.
  35.  
  36.    Setup    Sets up the color or mono screen and selects pulse or tone
  37.             dialing.  Sound may be turned on or off and an alternate
  38.             phone number directory can be loaded.  The modem initialization
  39.             string can be specified.  Changes can be saved to the current
  40.             directory file.
  41.    Edit     Edit the phone number file - add, delete, edit entries.
  42.    Manual   Allows dialing a number entered from the keyboard.
  43.    Find     Searches the number file for any text entered from the keyboard.
  44.    Again    Searches for the next entry that matches previous search.
  45.    Up       Scrolls toward the beginning of the file.  (shown as an up-arrow)
  46.    Dn       Scrolls toward the end of the file.  (shown as down-arrow)
  47.    Dial     Dials the high-lighted number.
  48.    Hangup   Sends the hangup code to the modem and clears the text portion of
  49.             the screen.
  50.    Toggle   Toggles demon dialing on and off.
  51.    Quit     Terminates the program and returns to DOS.
  52.  
  53.  
  54.    DIALING
  55.    -------
  56.    Select the number by scrolling the high-lighted line to the desired number.
  57.    Place the cursor on "Dial" and press the left mouse button, or with the
  58.    cursor anywhere, press the middle mouse button or "D" on the keyboard.
  59.  
  60.  
  61.  
  62.     DIALM31.DOC                                                 Page 2
  63.  
  64.  
  65.  
  66.    Dialing may be interrupted at any time by pressing either mouse button
  67.    or by pressing any key.
  68.    When dialing is completed, pick up the phone and press any button or key
  69.    to disconnect the modem and allow use of the handset.
  70.  
  71.    If your modem returns the "RINGING" result string the program will report
  72.    that the called number is ringing and tell you to pick up the phone
  73.    and press a key or mouse button.
  74.  
  75.  
  76.    RE-DIALING
  77.    ----------
  78.    Pressing "R" or pressing the RIGHT mouse button with the cursor on "DIAL"
  79.    will re-dial the last number dialed.  This is convenient if the last
  80.    number dialed was one that was entered from the keyboard.
  81.  
  82.  
  83.    DEMON DIALING
  84.    -------------
  85.    If demon dialing is ON and a dialed number is busy, the number will be re-
  86.    dialed after a short delay.  This re-dialing will continue for a maximum of
  87.    20 tries or until the phone answers.  Demon dialing will be interrupted if
  88.    any key or button is pressed, or if your phone rings.
  89.  
  90.  
  91.    SEARCHING THE DIRECTORY
  92.    -----------------------
  93.    The FIND and AGAIN selections can be used to search the directory for any
  94.    match in the name or description fields.  The up and down arrow selections
  95.    will scroll through the entries one line at a time when the left mouse
  96.    button is pressed, or one page at a time if the right button is pressed.
  97.    The up and down cursor control keys, as well as PAGE UP, PAGE DOWN, and HOME
  98.    keys can also be used.
  99.  
  100.  
  101.    MENUS
  102.    -----
  103.    Several sub-menus will pop up when certain commands are selected.  Most of
  104.    these as well as the main menu have "Q" as the quit selection.  The ESCAPE
  105.    key can also be used instead of the "Q" key.  Be careful not to hold down on
  106.    the "Q" or "ESCAPE" button too long or you will find yourself back at the
  107.    DOS prompt.
  108.  
  109.  
  110.  
  111. COMMUNICATIONS PORT AND MODEM
  112. =============================
  113.  
  114.    DIALM requires a Hayes or Hayes compatible modem.  The program attempts to
  115.    access the modem on both COM1 and COM2 ports.  If it cannot find a modem
  116.    on either port, the program will still run and can be used as a telephone
  117.    directory, but of course dialing will not be allowed.
  118.  
  119.    If your modem is on COM2 you may prevent the program from trying to access
  120.  
  121.  
  122.     DIALM31.DOC                                                 Page 3
  123.  
  124.  
  125.  
  126.    COM1 by typing at the DOS prompt:
  127.  
  128.           SET COMPORT=2
  129.  
  130.    The program communicates with the modem at 1200 baud because that seemed to
  131.    work better for my particular modem.  If your modem doesn't work at 1200
  132.    baud you can specify another baud (such as 300 baud) by the following
  133.    command:
  134.  
  135.           SET COMPORT=:300
  136.  
  137.    If you want to specify both the port and the baud, combine the commands:
  138.  
  139.           SET COMPORT=2:300
  140.  
  141.    
  142.    This program supports only COM1 and COM2 modem ports.
  143.  
  144.  
  145. PHONE NUMBER FILE
  146. =================
  147.  
  148.    The phone number file is created and edited by the program.  Each record in
  149.    this file contains 3 fields: a name, a number and an optional description.
  150.    When entering phone numbers it is only necessary to remember to put the phone
  151.    number in the second (center) field on the screen.
  152.    
  153.    The program re-sorts the file alphabetically by the name field each time an
  154.    entry is added or edited.  Whenever the file is re-written to the disk,
  155.    the previous version is saved with the ".BAK" extension.
  156.  
  157.    The maximum number of records that can be in the file is 200.
  158.   
  159.    DIALM expects to find the file "DIALM.DIR" on the default drive and
  160.    in the current directory, that is, the directory from which the program
  161.    is executed.
  162.  
  163.    You can tell DIALM to use a different file by typing (at the DOS prompt)
  164.    a command such as:
  165.  
  166.    SET DIAL=C:\PHONE.DIR
  167.  
  168.    You should use the correct path and file name to describe your file
  169.    after the '='.
  170.  
  171.    Another way to specify a directory file is as a program parameter:
  172.  
  173.    DIALM C:\PHONE.DIR
  174.  
  175.    A third way to use another file is by loading it in after the program
  176.    is running by using the SETUP PHONE command.
  177.  
  178.    In all cases the file will have the ".DIR" file type.  If another extension
  179.    is specified the program changes it to ".DIR".
  180.  
  181.  
  182.     DIALM31.DOC                                                 Page 4
  183.  
  184.  
  185.  
  186.  
  187. MONITOR
  188. =======
  189.  
  190.    DIALM was written for a color monitor.  The program determines if a color
  191.    adapter is present and if it is, it uses color. If the text is difficult
  192.    to read on a mono (black & white) monitor, you can turn the color off 
  193.    with the SETUP COLOR command.
  194.  
  195.  
  196.  
  197. A NOTE ABOUT ENVIRONMENT COMMANDS
  198. =================================
  199.  
  200.    If you use this program regularly and need to use the SET commands mentioned
  201.    above, they should be placed in your AUTOEXEC.BAT file so they will not have
  202.    to be entered each time the system is booted up.
  203.  
  204.    If you get the error message OUT OF ENVIRONMENT SPACE, and you are using
  205.    DOS 3.0 or later, put the following line in your CONFIG.SYS FILE:
  206.  
  207.    shell=c:\command.com /p /e:256
  208.  
  209.  
  210. FUTURE PROGRAM ADDITIONS
  211. ========================
  212.  
  213.    There are 2 possible additions that I have in mind for DIALM:
  214.  
  215.       1:  Tagging numbers to be dialed
  216.           ----------------------------
  217.           Perhaps 5 or 10 numbers could be tagged.  The program would dial
  218.           each tagged number until one was found that was not busy.
  219.  
  220.       2:  Logging
  221.           -------
  222.           Date, time and elapsed time of call could be written to a log file.
  223.  
  224.    The program as it stand fulfills my needs.  Implementation of additions to
  225.    it depends a lot on user input (hint).
  226.  
  227. SUPPORT
  228. =======
  229.  
  230.    I would be interested in hearing of any problems with the program and
  231.    will attempt to fix them in a later release.
  232.  
  233.    DIALM is distributed as user-supported software.  If you find the program
  234.    is useful you may send a donation of $5.00 to:
  235.  
  236.  
  237.  
  238.                         Robert Wilcox
  239.                         920 N. Washington St
  240.  
  241.  
  242.     DIALM31.DOC                                                 Page 5
  243.  
  244.  
  245.  
  246.                         Owosso, MI     48867
  247.  
  248.  
  249. WARRANTIES AND LIMITATIONS
  250. ==========================
  251.    You are granted permission to freely distribute DIALM in its
  252.    original form, without alteration, so long as this documentation is
  253.    distributed along with it and no fee is charged except for a reasonable
  254.    fee for media and shipping costs.
  255.  
  256.    I suggest that you distribute in the original ZIPped format.
  257.  
  258.    I DO NOT WARRANT THAT DIALM IS FIT FOR ANY PARTICULAR USE OR IS
  259.    MERCHANTABLE.  THIS PROGRAM IS NOT WARRANTED TO BE FREE OF BUGS, NOR
  260.    IS IT PROVIDED WITH ANY WARRANTY OF ANY KIND, EITHER EXPRESSED OR
  261.    IMPLIED.  IT IS YOUR RESPONSIBILITY TO DETERMINE WHETHER DIALM
  262.    IS SUITABLE FOR YOU.
  263.  
  264.    IN NO EVENT SHALL I BE HELD RESPONSIBLE FOR INCIDENTAL, SPECIAL OR
  265.    CONSEQUENTIAL DAMAGES, OR LOST DATA OR PROFITS TO ANY PERSON OR ENTITY
  266.    THAT MAY ARISE OUT OF THE USE OF THIS PROGRAM.
  267.  
  268. END OF DIALM.DOC                                     LAST REVISED 05/26/89
  269.  
  270.  
  271.